home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu723.dms / pu723.adf / PhotoCDAGA / PhotoCDAGA.doc < prev    next >
Text File  |  1994-11-20  |  10KB  |  312 lines
  1.                     PhotoCDAGA 1.0 by Günther Röhrich
  2.                     *********************************
  3.  
  4.  
  5. PhotoCDAGA is a viewer/converter for pictures in the PhotoCD format. It is
  6. based on the sources of the program "hpcdtoppm" written by Hadmut Danisch.
  7. For this reason you have to observe his copyright notice:
  8.  
  9.    hpcdtoppm (Hadmut's pcdtoppm) v0.6
  10.    Copyright (c) 1992, 1993, 1994 by Hadmut Danisch (danisch@ira.uka.de).
  11.    Permission to use and distribute this software and its
  12.    documentation for noncommercial use and without fee is hereby granted,
  13.    provided that the above copyright notice appear in all copies and that
  14.    both that copyright notice and this permission notice appear in
  15.    supporting documentation. It is not allowed to sell this software in 
  16.    any way. This software is not public domain.
  17.  
  18. All these terms do also apply to PhotoCDAGA. If you have more questions about
  19. legal issues then contact me or Hadmut Danisch. (you can find his address at
  20. the end of this doc)
  21.  
  22. Advantages of PhotoCDAGA:
  23.  
  24. - it does not cost you anything
  25. - complete source code is included, it can be compiled with all C compilers on
  26.   the Amiga
  27. - high speed (it is compiled with gcc 2.6.1, a part of it is written directly
  28.   in assembly language)
  29. - high picture quality gained by using the overskip mode and map-files
  30.   (probably better than with all other programs)
  31. - saving in ppm-format is possible to allow conversion into other picture
  32.   formats
  33.   (e.g. to IFF-ILBM with ppm2AGA or to JPEG with cjpeg)
  34.   In the NETPBM package you can find converters for almost all formats.
  35.   (Aminet: gfx/pbm)
  36.  
  37. Disadvantages: (sorry)
  38.  
  39. - needs lot of memory
  40. - not very comfortable (shell command)
  41. - overview is not (yet) possible
  42. - resolutions higher than Base (512x768) are not supported
  43.   (you have to use hpcdtoppm, the original, in this case)
  44.  
  45.  
  46. Many thanks to Hadmut Danisch for writing hpcdtoppm and releasing the source
  47. code to the public. Without his program PhotoCDAGA would not exist.
  48.  
  49. Also many thanks to all who have contributed to the GNU C compiler.
  50.  
  51.  
  52. Now I should start with the real documentation:
  53.  
  54. *******************************************************************************
  55. * ATTENTION: You have to increase your stack size to at least 10000 before    *
  56. *            starting PhotoCDAGA                                              *
  57. *******************************************************************************
  58.  
  59. System requirements:
  60.  
  61. An Amiga with lot of (virtual) memory and:
  62.  
  63. - AGA chipset
  64. - 68020 or higher processor
  65. - OS 3.0 or higher
  66. - ixemul.library V40.xx or higher in the LIBS: directory
  67. - a CD-ROM drive capable of reading Photo-CD's
  68.  
  69. As input to the program you need some pictures in the PhotoCD format. They have
  70. the ending .PCD and can be found in the directory PHOTO_CD/IMAGES on Photo-CD's.
  71.  
  72.  
  73. Installation
  74. ************
  75.  
  76. Copy the programs from the bin directory anywhere into your shell's search
  77. path. The ixemul.library (it is version 40.4, 68020 noFPU) should be copied to
  78. the LIBS: directory, if you don't have a newer one there.
  79.  
  80. For using the shell script PhotoMap you have to assign JPEGTMP: to a directory
  81. on your hard disk with enough free space. (e.g. assign JPEGTMP: HD:T) This is
  82. also needed to create map-files for the program jpegAGA.
  83. The best solution is to add this command to the user-startup file.
  84.  
  85. The shell script PhotoMap should be copied to the S: directory. It assumes that
  86. the programs PhotoCDAGA and ppm2AGA are available in the shell's search path and
  87. the JPEGTMP: directory exists. You may also need to set the MAPDIR environment
  88. variable, see later.
  89.  
  90.  
  91.  
  92. Invoking PhotoCDAGA:
  93. ********************
  94.  
  95. PhotoCDAGA PhotoCD-file [ppm-file] options
  96.  
  97.  
  98. PhotoCD-file
  99. ************
  100.  
  101. This should be a file in the PhotoCD format. (No overview files!)
  102. (e.g. cd:PHOTO_CD/IMAGES/IMG0001.PCD)
  103. If the format is wrong you will see garbage on the screen.
  104.  
  105. Note: Some pictures don't contain all resolutions. (If the file length is much
  106. shorter than 3MB.) It is possible that you will not be able to use the -x
  107. option for Base resolution in this case.
  108.  
  109.  
  110. ppm-file
  111. ********
  112.  
  113. This is the name of the ppm/pgm file that should be created. (Only needed when
  114. the -ppm or -pgm option is specified.)
  115.  
  116.  
  117. Options
  118. *******
  119.  
  120. -b Name
  121.    When using this option you must specify a name. This is needed to prevent
  122.    PhotoCDAGA from using the same map-file for different pictures if you have
  123.    more than one PhotoCD's. (see later) When creating map-files with the shell
  124.    script you have to set the same option.
  125.    This is only useful for color display.
  126.  
  127. -x
  128.    Use the overskip mode, this improves the color quality. If you are using the
  129.    Base resolution decoding will take much longer and will use much more
  130.    memory. (6MB is the absolute minimum, you have to boot with no Startup-
  131.    Sequence in that case.)
  132.    This option is not applicable for grayscale display/conversion.
  133.  
  134. -s
  135.    Make the picture sharper. Using this with a blurred picture it allows you to
  136.    detect more details in it.
  137.  
  138. -c
  139.    The program tries to cut off the black frame that sometimes appears at the
  140.    image borders.
  141.  
  142. -n
  143.    Don't rotate the picture. Normally PhotoCDAGA tries to find out the correct
  144.    orientation (portrait or landscape) and rotates the picture accordingly.
  145.  
  146. -r
  147.    Rotate the picture clockwise for portrait format.
  148.  
  149. -l
  150.    Rotate the picture counter-clockwise for portrait format.
  151.  
  152. -h
  153.    Flip the image horizontally.
  154.  
  155. -m
  156.    Write messages about the phase of decoding.
  157.  
  158. -c-
  159.    Darken the image.
  160.  
  161. -c+
  162.    Brighten the image.
  163.  
  164. -pgm
  165.    Create a pgm file. (8bit-grayscale) You have to specify a filename as
  166.    second option.
  167.  
  168. -ppm
  169.    Create a ppm file. (24bit-color) You have to specify a filename as second
  170.    option.
  171.  
  172. -gray
  173.    Show picture in grayscale mode.
  174.  
  175. -vga
  176.    Use the VGA (multiscan) screen mode for display.
  177.  
  178. -1
  179.    Use the Base/16 resolution. (128x192)
  180.  
  181. -2
  182.    Use the Base/4 resolution. (256x348)
  183.  
  184. -3
  185.    Use the Base resolution. (512x768) (default)
  186.  
  187.  
  188. You can stop decoding by pressing CTRL-C. If the screen is already opened press
  189. the right mouse button to stop. The screen has invisible but full functional
  190. drag bar and depth gadget. It has also the autoscroll feature.
  191.  
  192. If you want to create a normal IFF-ILBM file you have to create a ppm-file
  193. first and use the program ppm2AGA to convert. See the corresponding documen-
  194. tation for more.
  195.  
  196.  
  197. Creating the map-files
  198. **********************
  199.  
  200. These files are needed for showing pictures with best possible quality.
  201. Normally, they are created by the shell-script PhotoMap. You don't have to
  202. care about the details.
  203. Usage:
  204.  
  205.  PhotoMap PhotoCD-file [-b BaseName]
  206.  
  207. After succesfull completion a map-file with the correct name will be created.
  208. (On PC-filesystems too) You can process several pictures with a single invo-
  209. cation. The command
  210.  
  211.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD
  212.  
  213. will create, for example, a map-file for all pictures on a Photo-CD.
  214. If it is not possible to store the map-file at the same location as the picture
  215. itself (this is true for all CD-ROM's) then it will be stored in the directory
  216. pointed to by the environment variable MAPDIR. PhotoCDAGA will then also try to
  217. find the map-file in that place. You can set the environment variable e.g. with
  218. the command:
  219.  
  220.  setenv MAPDIR HD:tempdir
  221.  
  222. If you reset your machine the variable will get lost. To prevent this you can
  223. use the command:
  224.  
  225.  copy ENV:MAPDIR ENVARC:
  226.  
  227.  
  228. NOTE: Don't use the same map-file for different pictures, this will make the
  229. quality worse. If you have more than one Photo-CD you should use the -b option
  230. and specify a different base name for each CD. You must use the same option
  231. with the shell script and PhotoCDAGA itself.
  232.  
  233. If you have for example a PhotoCD with pictures from Australia then you can
  234. create the map-files with the command:
  235.  
  236.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD -b Australia
  237.  
  238. (Of course, the environment variable MAPDIR also must be set.)
  239.  
  240. Then you can look at the pictures e.g. with the command:
  241.  
  242.  PhotoCDAGA cd:PHOTO_CD/IMAGES/IMG0030.PCD -c -vga -b Australia
  243.  
  244. (If you have enough memory you can also use the -x option.)
  245.  
  246.  
  247.  
  248. If you have any comments/suggestions/bug reports then please contact me. Don't
  249. forget to mention your configuration for bug reports. (look below for an
  250. example)
  251.  
  252.  
  253. Tested configuration: (mine)
  254.  
  255. Amiga 4000/030, OS 3.0, 2MB Chip, 4MB Fast
  256. Processor: 68EC030/25MHz, Coprocessor: 68882/32MHz
  257.  
  258. CD-ROM drive: Mitsumi FX 001 D
  259. Controller: Tandem CD+IDE
  260. Filesystem: TandemCacheCDFS
  261.  
  262.  
  263. History
  264. *******
  265.  
  266. 1.0 - 20-November-1994
  267.  
  268.     - first public release
  269.  
  270.  
  271. Announcement
  272. ************
  273.  
  274. The actual version of this program does not offer very much. My spare time
  275. is very limited because I am now studying Electrical Engineering at the Uni-
  276. versity Stuttgart. Therefore I am searching for other developers to cooperate
  277. with me and beta-testers for testing purposes. If you want to join in then
  278. please contact me.
  279.  
  280.  
  281.  
  282. All messages/gifts/etc. should be sent to the following addresses:
  283.  
  284.  
  285.   electronic mail:                                  normal mail:
  286.   ****************                                  ************
  287.  
  288.  Guenther@studbox.uni-stuttgart.de                  Günther Röhrich
  289.      (Internet EMAIL)                               Lerchenbergstr. 4
  290.                                                     73733 Esslingen
  291.                                                         Germany
  292.  
  293.  
  294. If you don't get an answer to a EMAIL within 3 weeks then try it again
  295. with normal mail. (Normally I answer EMAIL's within 4 days. Only when
  296. I'm on holidays it may be different.)
  297.  
  298.  
  299. Here comes the address of Hadmut Danisch:
  300.  
  301. Hadmut Danisch  (danisch@ira.uka.de , will change in future)
  302. E.I.S.S.  (European Institute for System Security)
  303. Universitaet Karlsruhe
  304. Am Fasanengarten 5
  305.  
  306. D-76128 Karlsruhe  
  307.  
  308. Germany
  309.  
  310. FAX: +49 721 696893
  311. Tel./FAX privat: +49 721 607306  (will change in future)
  312.